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Limiting the amount of disk array history records per transfer from the web server 



A hpss\ pa\ properties\ serverpara meters. properties 



This parameter is read the first time an applet requests a range of disk array data to scroll through. 



This limits the amount of records the web server can send to the client to prevent a large amount of data 
from being dragged across the network atone time. To view a large amount of records, manually adjust 
the begin and end times on the web browser, and then request the records from the web server. 



!he following is used to keep an XM Ldata request that covers a large amount of time and, therefore, data 
records from tying up a servletwith a large transfer and even causing out-of-memory errors. The client can 
make requests for more data because it has a count of records that are available and can specify which 
record to start with for the next transfer. 
DiskArrayPerfHistoryMaxRecordTransfer=1000 




■Database backup, restore, and reset 



A Hpss\ padb\ tools DBBackup 
A Hpss\ padb\ tools DBRestore 



hen Accessed 



IW henever it becomes necessary to perform a database backup, restore, or reset of Performance Advisor XP. 
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Database Backup, Restore, and Reset 

You might need to perform a database backup, restore, or reset of Performance Advisor XP. To do so, you must 
be at the management station. 



Database Backup 

At the command line prompt, type cd . . . \Hpss\padb\toois. In the Tools directory, type DBBackup 
<date or other defining parameters For the defining parameter, it is recommended thatyou 
provide a date. For example, if you type DBBackup 09112004, the system will provide a backup of all data 
into a directory named 09112004. 



Database Restore 

At the command prompt, type cd . . . \Hpss\padb\toois. In the Tools directory, type DBRestore <date 
or other defining parameters Enter the same parameter that you typed at the command line prompt 
for the database backup. For example, if you typed DBBackup 09112004 to back up your data, you would 
then need to type DBRestore 09112004 to restore the data from the backup contained in the 09112004 
directory. 



Database Reset 

Ia t the command line prompt, type cd 

backup. 



. \Hpss\padb\toois. In the Tools directory, type DBRestore 



3 

These parameters are read whenever an alarm dispatch engine is started. An alarm dispatch engine is 
Bcomprised of various threads, and it is attached to a servlet. The servlet alarm tallies can be viewed in a 
Bweb browser at http:/ / <servername>/ servlet/ com.hp.xpsl.alarms.AlarmDispatchServlet. This is being 
Bmentioned here as a convenience and is not supported since its purpose is for developmentand 
Idebugging. The fields presented to the web browser are used in the dispatch engine's bookkeeping and do 
Bnot necessarily correspond to alarms that are sent to a particular destination. N evertheless, it does serve as 
Ba window for monitoring and general status purposes. See the Event History window for a more useful 
display. Send suggestions on how you would like to see this feature improved to better serve your needs. 



■Configuring the alarm dispatch engine on the web server 



A hpss\ pa\ properties\ serverpara meters. properties 




O nly the first two parameters are relevant to customer-site usage. The two default timeout values are 
greater than the normal error-sensing time that is actually necessary. These values are used to determine 
how long to wait on the dispatch courier's thread before stopping the thread. This prevents the alarm 
dispatch engine from locking up on an errant send request. 



The following is the amount of time in milliseconds to wait for an SMTP request to complete. 
Email_TimeOut=30000 

The following determines if real or fake data is used for alarms. 
1 -> use database data; 0 -> use fake data 
Listen_To_Database=l 

he following determines how long to sleep between sending groups of fake data, 
his is only active when not listening to the database. Units are milliseconds. 
Fake_Data_Sleep=120000 

he following is the email address separated by spaces. 
Fake_Email_Recipients=Some Person(5)hp.com 



Configuring the e-mail (SMTP) courier on the web server 
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A hpss\ pa\ properties\ serverpara meters. properties 



Each time an alarm is produced that has at least one e-mail recipient. 






The first two fields are used to establish a connection with the SMTP server. You must supply the SMTP 
servers your web server can talk to. Changing the "from" field is advisable for readability purposes, 
especially if the SMTP server checks for a valid sender. This is notto be used to spam people. Change the 
subject line and the definable message fields as desired. These areas are especially useful for adding 
ohrases for your particular locale, explaining what a message means, or receiving the message into a 
orogram that parses the main body of the message and performs some automated processing. Currently 
tiere are no levels of alarm severity for e-mail messages. 



The following line is used to specify where the SMTP server(s) are located. 

A server is specified by its name followed by its port. There can be an arbitrary amount of these pairs to 
try. They are used in the order that they appear here. An even number of space-delimited tokens are 
required in this string. An example is smtpserver.company.com 25 alternatesmtp.nonprofit.org 25 
If you cannot ping it, the code cannot talk to it! 
Add more pairs of servers and ports to achieve retries. 

SMTP_Servers_And_Ports=server. domainl.company.com 25 server.domain2.company.com 25 
server.domain3.company.com 25 

The following entry specifies who the e-mail is said to be coming from: 
SMTP Mail From=alarm server@your company.com 

The following entry is used for the subject field of the e-mail. This can have spaces. 
SMTP_Subject=XP Alarm 

The following are the fixed and user-defined messages for the alarm descriptions. 
CHIP_PCB_MP_Util_Fixed=Client/ Host Interface Processor Utilization 
CHIP PCB M P_Util_User=Front (Host) End Processor Utilization 
LDEV_Sequential_Reads_Fixed=Logical Device Sequential Reads 
LDEV_Sequential_Reads_User=Drive partition Sequential Reads 
LDEV_Sequential_W rites_Fixed=Logical Device Sequential W rites 
LDEV_Sequential_W rites_User=Drive partition Sequential W rites 
LDEV_Random_Reads_Fixed=Logical Device Random Reads 
LDEV_Random_Reads_User=Drive partition Random Reads 
LDEV_Random_W rites Fixed =Logica I Device Random W rites 
LDEV_Random_W rites_User=Drive partition Random W rites 
LDEV Sequential l O _rates_Fixed=Logical Device Sequential Input/ Output 
LDEV_Sequential_l_0_rates_User=Drive partition Sequential I/O 
LDEV_Random_l_0_rates_Fixed=Logical Device Random Input/ Output 
LDEV_Random_l_0_rates_User=Drive partition Random 1/ 0 
A C P PA IR_Utilization_Fixed=A rray Control Processor Utilization 
ACP_PAIR_Utilization_User=Back (Disk) End Processor Utilization 



jTopic 


Formatting and content of SN M P trap messages sent by PA XP 


File 




...\ hpss\ pa\ properties\ serverpara meters, properties 
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The message is of type SN M Pvl. It has the following forma nt and content: 
PDU version -- 0 (indicates type SN M Pvl) 
Community -- public 

M essage type -- 0xa4 (indicates a trap message) 
Enterprise -- The vendor identification (0 ID). 

Agent-Address -- The IP address of the management station where the trap is generated. 
Generic Trap Type -- 6 (enterprise-specific) 
Specific Trap Type - 4 (indicates a notice event) 
Timestamp - 0 (not used) 

Variable bindings - This field consists of a sequence of (o id/ name=value) pairs. The content is the same as the 
message that is sent by e-mail. 

The following is the format of the pair: 
<Enterprise>.l Server=<Host name of the management station> 
<Enterprise>.2 Sequence_N umber=<Sequence number in Event History> 
<Enterprise>.3 Alarm_Source=l 

<Enterprise>.4 Alarm_M ajor_Type=<M ajor type of the alarm event> 
<Enterprise>.5 Alarm_M inor_Type=<M inor type of the alarm event> 
<Enterprise>.6 Specifi c_ltem=<Procedure name of the alarm event> 
<Enterprise>.7 Array_ID=<Array ID of the alarm event> 
<Enterprise>.8 Array_Type=<Array type of the alarm event> 
<Enterprise>.9 M aximum_Threshold=<The maximum value of this trigger event> 
<Enterprise>.10 Actual_Value=<The actual value when this event is triggered> 
<Enterprise>.ll Time_Posted=<Time this event is triggered> 
<Enterprise>. 12 Time_Updated=<Time this event is updated> 

The value of the Enterprise is defined in the serverpara meter. properties file. 
The key is SN M P_Enterprise. 




Topic 


Configuring the host agent: M anagementStation. Hostname 






0 n W indows platforms: 

C:\ Program Files\ Hewlett-Packard\ sanmgr\ hostagent\ config\ paxp_service. properties 




On UNIX platforms: 

/ opt/ sanmgr/ hostagent/ config/ paxp_service. properties 


W hen Read 




This parameter is read when the host agent is started. The host station normally executes as a service under 
M icrosoft W indows or as a daemon under UN IX. 


Discussion 


IP address or fully-qualified network name of management station. 

N ote: This hostagent is configured automatically during hostagent installation. Configure this hostagent 
manually only when you wantto change the management station after installing the hostagent. 


Return to Top 
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Configuring the host agent: M anagementStation.PolllntervalM illiSeconds 


File 


0 n W indows platforms: 

C:\ Program Files\ Hewlett-Packard\ sanmgr\ hostagent\ config\ paxp_service. properties 
On UNIX platforms: 

/ opt/ sanmgr/ hostagent/ config/ paxp_service. properties 




W hen Read 


Th i c r\ a ra mot"o r ic roaH cnorifioH at" n in hi mo 
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Discussion 


1 


The frequency at which the Host station polls the M anagement station for updates. The default for the polling 
rvrle k fiflflflfl (fif) <;prnnd<;) 







Topic 


Configuring the password required to access PA XP 


Discussion 


|N ote: The user can change user/ administrator passwords through the GUI. 




1 Return to Top 

t ! 1 





j 


Expanding the database size to retain up to 32 G B of data 




N ote: The user can change the database size through the G Ul. 





Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but 
not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett- 
Packard shall not be liable for errors contained herein or for incidental or consequential damages in 
connection with the furnishing, performance, or use of this material. 



This document contains proprietary information, which is protected by copyright. N o part of this 
document may be photocopied, reproduced, or translated into another language without the prior 
written consentof Hewlett-Packard. The information contained in this document is subject to change 
without notice. 

AIX is a US registered trademark of International Business M achines Corporation. 

HP-UX Release 11.00 and later (in both 32 and 64-bit configurations) on all HP 9000 computers are 

O pen G roup UN IX 95 branded products. 

Java™ is a US trademark of Sun M icrosystems, Inc. 

UN IX® is a registered trademark of The O pen G roup. 

Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained 
herein. The information is provided "as is" without warranty of any kind and is subject to change 
without notice. The warranties for Hewlett-Packard Company products are set forth in the express 
limited warranty statements for such products. N othing herein should be construed as constituting an 
additional warranty. 
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